home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / PutChar 2.1 / PutChar.doc < prev    next >
Text File  |  1996-09-26  |  5KB  |  98 lines
  1. PutChar 2.1
  2. -----------
  3.  
  4. (c) 1992/93
  5.  
  6. V2.1 (19.6.93): New ToolTypes, keyfunctions, improvements.
  7.  
  8. Author: Urs Fleisch
  9.         Leimatstr. 38
  10.         CH-9000 St. Gallen
  11. E-mail: ufleisch@stud.ee.ethz.ch
  12.  
  13. This program is PUBLIC DOMAIN, and may be freely distributed, however
  14. always together with this documentation!
  15.  
  16. This program is a utility like PopChar on the Apple MacIntosh.
  17. PutChar enables you to use all ASCII-codes in any application whether the
  18. code is in the current keymap or not. The possibility of loading fonts
  19. allows you to work reasonable even with fonts that don't have the standard
  20. character set, e.g. foreign fonts, Greek letters or mathematical symbols.
  21. PutChar runs on every Amiga, but it takes also advantage of the power of
  22. some libraries and Kickstart 2.0.
  23.  
  24. Starting PutChar 2.1:
  25.  
  26. Kickstart 1.3: To run PutChar, you don't need any libraries, but to use the
  27. font loading function, you should have diskfont.library in your LIBS:
  28. drawer. PutChar runs from Workbench or CLI. At once, the PutChar window
  29. appears.
  30. Kickstart 2.0: Also with Kickstart 2.0, you don't need any libraries, but
  31. then you'll do without some functions. To load fonts, you need
  32. diskfont.library. Newer versions of diskfont.library allow you to use
  33. scalable fonts too. Asl.library gives you a comfortable fontrequester.
  34. Finally commodities.library lets you run PutChar as a commodity.
  35. Run as a commodity, the PutChar-window only appears if there's a ToolType
  36. CX_POPUP=YES set. Otherwise nothing happens on the screen after starting
  37. PutChar. The program is now waiting for the HotKey to be pressed. The
  38. default HotKey is "lalt control p". Pressing this key combination activates
  39. PutChar and the window will appear. Closing the window doesn't kill PutChar
  40. in memory, it still waits for the HotKey until you kill it by starting it
  41. again or by killing it from Commodities-Exchange.
  42. The HotKey and the Commodity's priority can be set by ToolTypes CX_POPKEY
  43. and CX_PRIORITY. The default selection is "CX_POPKEY=lalt control p" and
  44. "CX_PRIORITY=0". You can assign any Commodities-HotKey-string to CX_POPKEY,
  45. e.g. shift, alt, caps, control, lshift, rshift, lalt, ralt, lcommand,
  46. rcommand and so forth. CX_PRIORITY can reach from -128 to 127. By setting
  47. CX_POPUP=YES, the window pops up after starting PutChar. The default value
  48. is CX_POPUP=NO. The two ToolTypes FONT and SIZE set the font, with which
  49. PutChar is started. So FONT=topaz.font SIZE=9 chooses the font Topaz with
  50. size 9 as the startup font. If you don't use these two ToolTypes, PutChar
  51. starts with the actual screenfont. When started with invalid ToolTypes,
  52. PutChar makes use of the default preferences. You can also deliver the
  53. ToolTypes to PutChar when starting from CLI or a script like
  54. s:user-startup, e.g. 'Run >NIL: PutChar CX_POPKEY="control f10"
  55. CX_PRIORITY=1'. Here, CX_POPUP works as a switch, so don't write
  56. CX_POPUP=YES, but only CX_POPUP to let the window appear when the program
  57. is started.
  58.  
  59. Using PutChar 2.1:
  60.  
  61. After starting PutChar or pressing the HotKey, the PutChar window appears.
  62. Its look and size depends on the Screen on which it is opened. The font is
  63. the actual screenfont, the font set by "SetFont" from the shell or the font
  64. set by the ToolTypes. Once closed the window, by reopening the window by
  65. invoking PutChar through the HotKey, the last used font is being displayed.
  66. The extent of the window adjusts to the font. With proportional fonts,
  67. PutChar always takes a width of 19 points, so do not use extremely large
  68. proportional fonts (or they won't be fully displayed, too big fonts are
  69. replaced by Topaz/8). You may change the actual font by clicking on the
  70. gadget "Load Font" or pressing 'L' on the keyboard. Then you can load
  71. another font with the ASL-fontrequester or (without asl.library) a simple
  72. fontrequester. By the way, you can open the PutChar window on every screen
  73. (Interlaced, HAM...), but be careful. Close the PutChar window before you
  74. quit the program who opened the screen unless you want to loose
  75. chip-memory.
  76. When you work in a wordprocessor e.g. with a symbol-font, so load the same
  77. font into PutChar. Now you can choose any character by clicking with the
  78. mouse on it or choosing it with the cursor-keys; the chosen character will
  79. be displayed in the upper left of the window in decimal, hex and
  80. Topaz-font. By clicking on the position in the wordprocessor-window on
  81. which you want to have the chosen character, the character is being
  82. displayed. To choose other characters, click again in the PutChar window on
  83. the desired character and then into the window of the application.
  84.  
  85. How works PutChar?
  86.  
  87. The activation of another window tells PutChar to generate a character. So
  88. it temporarily changes in the actual keymap the character of the key '1',
  89. because this key is surely available in every application. Then it
  90. simulates the pressing of this key and fixes the keymap. So you can use all
  91. ASCII-codes with every keymap.
  92. Presupposition for working with PutChar is that there has been a keymap
  93. loaded into RAM by "SetMap" or the "Input Preferences" because PutChar
  94. can't modify the default keymap in ROM. Programs who use the system keymap
  95. should work with PutChar, and these are nearly all available programs. So
  96. software like FinalCopy II, WordPerfect, Vizawrite, Excellence, Personal
  97. Write, Cygnus Ed, PageStream, Deluxe Paint IV... works fine with PutChar.
  98.